home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / wildcat / actsta12.zip / ACTSTAT.DOC < prev    next >
Text File  |  1992-01-27  |  6KB  |  135 lines
  1.  
  2.                          ACTSTAT  Version 1.2
  3.  
  4.              WILDCAT 3 activity log(s) statistics generator
  5.          Written by C.Dutton from 2 SPITS BBS (+44) 0959-540991
  6.  
  7.           This program if FREE and NO registration is required.
  8. If you find any problems or have any suggestions for improvments please
  9. drop me a line on the BBS.
  10.  
  11.                         Installation.
  12.                         -------------
  13.         ACTSTAT.EXE
  14.         -----------
  15.     This file must be run in the same directory as your ACTIVITY.???
  16. file(s) for the program to work. It will then read ALL ACTIVITY.??? files
  17. in that directory.
  18.                   
  19.         ACTSTAT.CFG
  20.         -----------
  21.     Installation is simple just edit the ACTSTAT.CFG file to suit your
  22. WILDCAT setup & place the file in the same directory as ACTSTAT.EXE.
  23. An example is included and below is what it all means.
  24.  
  25. file :ACTSTAT.CFG
  26. 2 SPITS BBS (+44) 0959-540991 ───── Your bbs name (MAX 44 chars)
  27. c:\wc30\bull\bull1.bbs      ─────── path & name of bulletin (MAX 48 chars)
  28. 1                           ─────── background colour
  29. 15                          ─────── border colour    (see below for colours)
  30. 13                          ─────── box title colour
  31. 14                          ─────── text colour
  32. 10                          ─────── statistical data colour
  33. Zmodem                      ────┐
  34. Xmodem                          │  The names of your protocols
  35. Xmodem/CRC                      │  as they exist in your ACTIVITY.??? log(s)
  36. Ymodem                          │  (MAX 13 characters)
  37. Ymodem/G                        ├─ Upto 10 protocols may be named here
  38. Moby Turbo                      │  and partial names are allowed.
  39. Tmodem                          │  e.g 'Tmodem' is actually 'Tmodem V7.10'
  40. CCSP                            │      in our ACTIVITY log's but a newer
  41. Kermit                          │      Version is inevitable. So 'Tmodem'
  42. Ascii                        ───┘      Will reflect all versions.
  43.  
  44. There is also an 11th protocol called 'Other' but this is used to count
  45. the use of any unspecified protocol names (Very useful for setting up
  46. the protocols you have). The 'Other' protocol option is only printed on
  47. the bulletin if it has found Protocols NOT used in your ACTSTAT.CFG file.
  48.     e.g the Protocol Other is greater than 0
  49.  
  50.     WARNING
  51.     Entering 'Ymodem' and 'Ymodem G' in your ACTSTAT.CFG file should be
  52. done with care as  if 'Ymodem' comes before 'Ymodem G', all uses of
  53. 'Ymodem G' will be counted as 'Ymodem'.
  54.  
  55.      COLOURS
  56.      There MUST be 5 colours entered on SEPERATE lines.
  57. All colours are as per the Wildcat Manual BUT in decimal.
  58. eg. @1F@ = @(background)(foreground)@  so this would be BLUE background
  59.     with a value of 1 & BRIGHT WHITE foreground with a value of 15.
  60. It's HEXADECIMAL simple really (0,1,2,3,4,5,6,7,8,9, A, B, C, D, E, F)
  61.                                (0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15)
  62.  
  63.         ACTSTAT.HST
  64.         -----------
  65.     This file is a history file of the Current stats generated.
  66. If you DO NOT delete this file then you SHOULD DELETE or MOVE your
  67. 'ACTIVITY.???' files as the statistics generated are Cumulative.
  68.     e.g run ACTSTAT and the ACTSTAT.HST files is generated.
  69.         run ACTSTAT again and you now have DOUBLED your Statistics.
  70.         Twice as many calls,downloads,uploads,messages,etc
  71.  
  72.                         Some Sample ideas for stats
  73.                         ---------------------------
  74.     By running ACTSTAT you can delete your activity log every day (no
  75. more enormous activity.001 files).
  76.     By running the following .BAT example you can generate daily stats
  77. as well.
  78. DIR TREE
  79. --------
  80.   C:\─┬─WC\─┬─STORAGE\
  81.       │     ├─BULL\
  82.       │     └─DATA\
  83.       └─DOS\
  84.  
  85. EVENT1.BAT
  86. ----------
  87. C:
  88. CD \WC
  89. rem ******* update total stats for your bbs ********
  90. COPY C:\WC\STORAGE\ACTSTAT.HST C:\WC >nul
  91. COPY C:\WC\STORAGE\ACTSTAT.TOT C:\WC\ACTSTAT.CFG >nul
  92. ACTSTAT
  93. COPY C:\WC\ACTSTAT.HST C:\WC\STORAGE >nul
  94. DEL C:\WC\ACTSTAT.HST >nul
  95. rem ******* update daily stats for your bbs ********
  96. COPY C:\WC\STORAGE\ACTSTAT.DAY C:\WC\ACTSTAT.CFG >nul
  97. ACTSTAT
  98. DEL C:\WC\ACTSTAT.HST >nul
  99. rem ******* run any other activity.??? reading *******
  100. rem ******* bull creators befor the next line *******
  101. rem ******* now delete or move the days activity log(s) ******
  102. DEL ACTIVITY.???
  103.  
  104.  
  105.                         The History Editor
  106.                         ------------------
  107.     Well as promised in version 1.00. The editor has arrived (simple
  108. though it is). It will allow you to edit/change any stats that you wish
  109. to in the history file generated. But do it with a COPY till you get
  110. used to it. It was a rushjob but it works (you should'nt need it anyway).
  111.     ACTEDIT.EXE should also be in the same directory as the ACTSTAT.EXE &
  112. ACTSTAT.CFG files for it to be run. BUT you could copy your history &
  113. config files to where the editor is to do the editing.
  114.  
  115.     Editing tips
  116. 1). The edit is as the Bulletin looks so you will recognise the layout.
  117. 2). The TOTAL DOWNLOADS/UPLOADS is calculated in the program from UP/DN
  118.     protocols so it will change if you edit the protocols.
  119. 3). The total calls should match the CALLS/DAY & CALLS/TIME totals.
  120. 4). The number of CALLS should match the TYPES OF CALL (300,1200,.....)
  121.     these include LOCAL LOGINS & DENIED ACCESS.
  122. 4). The number of CALLS should also match the TYPES OF LOGOUT (normal,
  123.     dropped carriers,......) these also include DENIED ACCESS.
  124.  
  125.  
  126.                              ADDENDUM
  127.                              --------
  128.     The history file HAS been changed but an auto update will be performed
  129. when the program is run so no need to start all over again.
  130.  
  131. Well hope you like it & Please check I have got all the info you want
  132. before you delete your activity.??? (logs)
  133.  
  134.   (ALL THESE PROGRAMS ARE USED ON OUR BBS WITH NO PROBLEMS ENCOUNTERED)
  135.